home *** CD-ROM | disk | FTP | other *** search
/ Internet Tools (InfoMagic) / Internet Tools.iso / news / moderating / README.atari.Z / README.atari
Text File  |  1993-09-19  |  3KB  |  103 lines
  1. These are the tools I use to moderate comp.sources.atari.st and comp.binaries.
  2. atari.st.  My setup is unusual in that I have an archive server (mail-based) on
  3. my machine, so these tools maintain that as well.
  4.  
  5. This depends on there being a "binaries" directory and a "sources" directory,
  6. inside of which are files Index.1 (index of the current volume) and Index.2
  7. (index of all previous articles.)
  8.  
  9. What I generally do when something new comes in:
  10.  
  11. 1. Wait way too long. :)
  12. 2. Unpack the program and test it.
  13. 3. Repackage it if necessary; I try to keep all outgoing messages under 50K,
  14.    so if necessary I split large postings up into several parts.  Multipart
  15.    postings go into subdirectories, in files named "part01", "part02", etc.
  16.    I also repackage if the submitter used a really old archiver with lousy
  17.    compression, etc.
  18. 4. Run "tweak filename" or, on multipart postings, "tweak part*".  The tweak
  19.    program and its support files (Header.*) do 90% of the work.
  20. 5. Run "post b programname" or "post s programname" depending on whether the
  21.    file is going to comp.binaries.atari.st or comp.sources.atari.st.  (Yeah,
  22.    it should look at the path like tweak does.  Sue me.)  The post script
  23.    is smart about multipart postings ("programname" can be a directory) and
  24.    will limit the number of messages that go out per invocation by fiddling
  25.    with the permissions of parts.  It also copies the files to the appropriate
  26.    archive directory when everything is posted.
  27.  
  28. A nightly cron job (update-autoindex) runs a diff of the previous day's index
  29. and today's index, mailing the diff results to a list of people who don't
  30. receive the newsgroup but are able to access the mail server.
  31.  
  32. The manifest:
  33.  
  34. Changing.volume
  35.     A list of what I have to do to change to a new volume in either group.
  36.     Used to be much longer before I wrote newvol.
  37.  
  38. Header.binaries
  39. Header.binaries.multi
  40. Header.sources
  41. Header.sources.multi
  42. sedfile
  43. seq.binaries
  44. seq.sources
  45.     Used by the tweak program.
  46.  
  47. Index.binaries.h
  48. Index.sources.h
  49.     The Index.2 files from each directory with a news header, for posting
  50.     at the start of each volume.
  51.  
  52. Intro.binaries
  53. Intro.sources
  54. unpack.ms
  55.     Introductory blurbs about the two groups.
  56.  
  57. Makefile
  58.     The makefile (duh.)  Doesn't build everything.
  59.  
  60. README
  61.     You are in trouble if you can't figure this one out.
  62.  
  63. autoindex-intro
  64.     A text file that I mail to people who want to know about the automatic
  65.     notification by mail of new things in the archive.
  66.  
  67. dehex.c
  68.     A utility for decoding the occasional weird-format file from BITNET.
  69.  
  70. newvol
  71.     A script that does most of the work of switching to a new volume,
  72.     creating directories and initializing the index files.
  73.  
  74. nodocs.b
  75.     A blurb asking people to include docs with binary submissions.
  76.  
  77. post
  78.     The aforementioned post script.
  79.  
  80. tweak.c
  81.     The tweak program.
  82.  
  83. ucat.c
  84.     A dumb program for gluing together multipart uuencoded submissions
  85.     that people didn't bother running through a deluxe uuencode like "uue".
  86.  
  87. update-autoindex
  88.     Run once a day by cron.
  89.  
  90. volume
  91.     Output the current volume number (used by tweak and post)
  92.  
  93. wrong-group
  94.     A blurb telling people they should post to comp.sys.atari.st.
  95.  
  96. That's about it.  This is automated enough to keep me happy; it could be
  97. made more so (e.g. tweak could put things in an "outgoing" queue that gets
  98. scanned daily by a cron job, eliminating the need for manual use of the
  99. "post" script.)
  100.  
  101. -Steve
  102.  koreth@eng.sun.com
  103.